home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / ftn / glcomp.z / glcomp
Encoding:
Text File  |  1998-10-20  |  14.6 KB  |  265 lines

  1.  
  2.  
  3.  
  4. ggggllllccccoooommmmpppp((((3333GGGG))))                                                          ggggllllccccoooommmmpppp((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllccccoooommmmpppp - controls compatibility modes
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ggggllllccccoooommmmpppp((((mmmmooooddddeeee,,,, vvvvaaaalllluuuueeee))))
  13.      iiiinnnntttteeeeggggeeeerrrr****4444 mmmmooooddddeeee
  14.      iiiinnnntttteeeeggggeeeerrrr****4444 vvvvaaaalllluuuueeee
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  17.      _m_o_d_e    the name of the compatibility mode you want to change.  The
  18.              available modes are:
  19.  
  20.              GGGGLLLLCCCCOOOOLLLLDDDD controls the state of old-style polygon mode.
  21.  
  22.              GGGGLLLLCCCCZZZZRRRRAAAA controls the state of z-range mapping mode.
  23.  
  24.              GGGGLLLLCCCCSSSSOOOOFFFF controls whether this program will keep mouse focus when a
  25.              shift or control key is pressed.
  26.  
  27.              GGGGLLLLCCCCMMMMAAAANNNN sets imakebackground windows to be override redirect.
  28.  
  29.              GGGGLLLLCCCCSSSSLLLLOOOO controls whether mapcolor calls are buffered.
  30.  
  31.              GGGGLLLLCCCCIIIINNNNPPPP controls whether extra INPUTCHANGE events are generated
  32.              when entering and leaving a subwindow.
  33.  
  34.              GGGGLLLLCCCCNNNNOOOOBBBB controls whether a noborder() window can regain its
  35.              border.
  36.  
  37.              GGGGLLLLCCCCMMMMQQQQEEEE controls the compression of motion events.
  38.  
  39.              GGGGLLLLCCCCFFFFOOOORRRR controls which colormaps will be installed when an RGB
  40.              window receives colormap focus.
  41.  
  42.              GGGGLLLLCCCCSSSSEEEETTTT sets the value of the vertical retrace counter.
  43.  
  44.              GGGGLLLLCCCCGGGGEEEETTTT returns the present value of the vertical retrace counter.
  45.  
  46.              GGGGLLLLCCCCVVVVSSSSYYYY puts the calling process to sleep until the vertical
  47.              retrace counter reaches some specified value.
  48.  
  49.              GGGGLLLLCCCCTTTTAAAABBBB determines how tablet coordinates are scaled when the
  50.              tablet controls the graphics cursor.
  51.  
  52.      _v_a_l_u_e   the value you want to set for the specified compatibility mode.
  53.  
  54. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  55.      ggggllllccccoooommmmpppp gives control over details of the graphics compatibility between
  56.      IRIS-4D models.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllccccoooommmmpppp((((3333GGGG))))                                                          ggggllllccccoooommmmpppp((((3333GGGG))))
  71.  
  72.  
  73.  
  74.    OOOOlllldddd----SSSSttttyyyylllleeee PPPPoooollllyyyyggggoooonnnn MMMMooooddddeeee ((((GGGGLLLLCCCCOOOOLLLLDDDD))))
  75.      By default, old-style polygon mode is 1.  Setting it to 0 speeds up old-
  76.      style drawing commands but the output is subtly different.  See the
  77.      ``High-Performance Drawing'' and ``Old-Style Drawing'' sections of the
  78.      _G_r_a_p_h_i_c_s _L_i_b_r_a_r_y _P_r_o_g_r_a_m_m_i_n_g _G_u_i_d_e for further explanation of the two
  79.      modes and their effects on various machines.
  80.  
  81.           Old-style polygon are polygons drawn with any GL commands other than
  82.           bgnpol/endpol, bgntme/endtme, or bgnqst/endqst.
  83.  
  84.      WARNING: some features added recently to the Graphics Library are not
  85.      supported by old-style polygons.  These features include texture mapping,
  86.      fog, and polygon antialiasing.  Use new-style polygon commands, or set
  87.      GGGGLLLLCCCCOOOOLLLLDDDD to 0, to insure correct operation of new rendering features.
  88.  
  89.      This is a per-window mode.
  90.  
  91.    ZZZZ----RRRRaaaannnnggggeeee MMMMaaaappppppppiiiinnnngggg MMMMooooddddeeee ((((GGGGLLLLCCCCZZZZRRRRAAAA))))
  92.      When z-range mapping mode is 0, the domain of the z-range arguments to
  93.      llllsssseeeettttddddeeee, llllRRRRGGGGBBBBrrrraaaa, and llllsssshhhhaaaaddddeeee depends on the graphics hardware.  When
  94.      multisample is enabled, and multisample buffers exist in the current
  95.      framebuffer configuration in the current drawmode, the minimum is the
  96.      value returned by ggggeeeettttggggccccoooo((((GGGGCCCCMMMMZZZZMMMMIIII)))) and the maximum is the value returned by
  97.      ggggeeeettttggggccccoooo((((GGGGCCCCMMMMZZZZMMMMAAAA)))).  Otherwise, the minimum is the value returned by
  98.      ggggeeeettttggggccccoooo((((GGGGCCCCZZZZMMMMIIIINNNN)))) and the maximum is the value returned by ggggeeeettttggggccccoooo((((GGGGCCCCZZZZMMMMAAAAXXXX)))).
  99.      When this mode is 1, these routines accept the range $0 to $7FFFFF; it is
  100.      mapped to whatever range the graphics hardware supports.
  101.  
  102.      In order to maintain backwards compatibility, the default GLCZRA is 1 on
  103.      IRIS-4D B and G models, and 0 on all others.
  104.  
  105.      This is a per-process mode.
  106.  
  107.    SSSSoooofffftttt AAAAttttttttaaaacccchhhh ((((GGGGLLLLCCCCSSSSOOOOFFFF))))
  108.      Under previous window systems, if any keyboard key was held down, a
  109.      window would keep receiving mouse events, even if the mouse moved out of
  110.      the window.  This type of input distribution is not supported as a
  111.      generally available focus policy in X, so the GL provides a similar
  112.      behavior from programs which ask for it.  If a program sets GLCSOF to
  113.      true, then holding down any of the modifier keys (other than _a_l_t) locks
  114.      the mouse focus onto that window until all modifier keys (other than _a_l_t)
  115.      are released.  (Modifier keys other than _a_l_t are _s_h_i_f_t and _c_o_n_t_r_o_l.)
  116.  
  117.    iiiimmmmaaaakkkkeeeebbbb wwwwiiiinnnnddddoooowwww ccccoooonnnnttttrrrroooollll ((((GGGGLLLLCCCCMMMMAAAANNNN))))
  118.      If set to true, imakeb windows will be managed by the window manager.
  119.      The correct setting of this will vary based on type of background program
  120.      and type of machine and the user's selection of window managers.  See the
  121.      man page on imakeb for more info.
  122.  
  123.    BBBBuuuuffffffffeeeerrrreeeedddd mmmmaaaappppccccoooolllloooorrrr ((((GGGGLLLLCCCCSSSSLLLLOOOO))))
  124.      If set to true, then mapcolor requests are flushed to the window server
  125.      as soon as they are made.  If a program is calling mapcolor many times,
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ggggllllccccoooommmmpppp((((3333GGGG))))                                                          ggggllllccccoooommmmpppp((((3333GGGG))))
  137.  
  138.  
  139.  
  140.      this will be very inefficient.
  141.  
  142.    IIIINNNNPPPPUUUUTTTTCCCCHHHHAAAANNNNGGGGEEEE bbbbuuuugggg ccccoooommmmppppaaaattttiiiibbbbiiiilllliiiittttyyyy ((((GGGGLLLLCCCCIIIINNNNPPPP))))
  143.      This controls what INPUTCHANGE events are delivered as focus moves from a
  144.      window to a subwindow.  Before 4.0 an INPUTCHANGE with value "0" was
  145.      generated as the focus transitioned between a window and its subwindows.
  146.      In 4.0 INPUTCHANGE "0" always means that the focus has moved to a
  147.      different top level window.  Setting this glcompat value to True will
  148.      enable the pre 4.0 behavior.
  149.  
  150.    nnnnoooobbbboooorrrr(((()))) bbbbuuuugggg ccccoooommmmppppaaaattttiiiibbbbiiiilllliiiittttyyyy ((((GGGGLLLLCCCCNNNNOOOOBBBB))))
  151.      Calling wincon() can restore a border previously removed by a call to
  152.      nobor().  This was not the case before release 4.0.  Setting this
  153.      glcompat value to True will enabe the pre 4.0 behavior.
  154.  
  155.    CCCCoooolllloooorrrrmmmmaaaapppp iiiinnnnssssttttaaaallllllllaaaattttiiiioooonnnn ffffoooorrrr RRRRGGGGBBBB wwwwiiiinnnnddddoooowwwwssss ((((GGGGLLLLCCCCFFFFOOOORRRR))))
  156.      When an RGB window receives colormap focus, the colormap for color index
  157.      windows is not affected.  Setting this glcompat value to True will cause
  158.      the color index colormap to be installed when an RGB window gets colormap
  159.      focus.
  160.  
  161.    MMMMoooottttiiiioooonnnn eeeevvvveeeennnntttt ccccoooommmmpppprrrreeeessssssssiiiioooonnnn ((((GGGGLLLLCCCCMMMMQQQQEEEE))))
  162.      If the value of GGGGLLLLCCCCMMMMQQQQEEEE is zero, then motion events are received
  163.      unaltered, with no compression.  But if the value is greater than zero,
  164.      it is the maximum number of events per second at which the GL Q is
  165.      allowed to grow when motion events are received.  For example if the
  166.      value of GGGGLLLLCCCCMMMMQQQQEEEE is equal to 5, then the GL Q will grow by at most 5
  167.      motion events per second.
  168.  
  169.      If a new event arrives at a rate faster than allowed by GGGGLLLLCCCCMMMMQQQQEEEE,,,, the new
  170.      event is never thrown away.  Rather, the new event overwrites the
  171.      previously most recent event in the GL Q.  That is, using a positive
  172.      value for GGGGLLLLCCCCMMMMQQQQEEEE will not in any way prohibit a program from keeping up
  173.      with the device.
  174.  
  175.      There are two defines in <_g_l._h> which may be used for the value of
  176.      GGGGLLLLCCCCMMMMQQQQEEEE.... The first is GGGGLLLLCCCCCCCCOOOOMMMM,,,, which gives an event rate similar to pre
  177.      4.0.  The second is GGGGLLLLCCCCCCCCMMMMPPPP,,,, which yields maximum "compression" of motion
  178.      events.
  179.  
  180.    VVVVeeeerrrrttttiiiiccccaaaallll rrrreeeettttrrrraaaacccceeee ccccoooouuuunnnntttteeeerrrr ccccoooonnnnttttrrrroooollll ((((GGGGLLLLCCCCSSSSEEEETTTT,,,,GGGGLLLLCCCCGGGGEEEETTTT,,,,GGGGLLLLCCCCVVVVSSSSYYYY))))
  181.      GGGGLLLLCCCCSSSSEEEETTTT sets the initial value of the vertical retrace counter to the
  182.      given _v_a_l_u_e. The vertical retrace counter will then increment by one on
  183.      every vertical retrace of the screen display.  The frequency of this
  184.      increment is governed by the video output format in use.  GGGGLLLLCCCCGGGGEEEETTTT allows
  185.      the caller to get the current value of the vertical retrace counter.
  186.      This value will be stored in the location pointed to by _v_a_l_u_e. Thus _v_a_l_u_e
  187.      should be used as a pointer to an integer into which GGGGLLLLCCCCGGGGEEEETTTT stores the
  188.      current value of the vertical retrace counter.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ggggllllccccoooommmmpppp((((3333GGGG))))                                                          ggggllllccccoooommmmpppp((((3333GGGG))))
  203.  
  204.  
  205.  
  206.      GGGGLLLLCCCCVVVVSSSSYYYY puts the calling process to sleep until the remainder of the
  207.      vertical retrace counter divided by the specified interval equals the
  208.      specified mod.  For example, if the current value of the vertical retrace
  209.      counter is 126, the specified interval is 5, and the specified mod is 3,
  210.      then the calling process is immediately put to sleep for two vertical
  211.      retrace intervals.  When the vertical retrace count reaches 128 (such
  212.      that 128 mod 5 equals 3), the process is woken up.  _V_a_l_u_e in this case is
  213.      a pointer to an array of two integers, the first integer specifies the
  214.      interval, the second integer specifies the mod.
  215.  
  216.      Note that the above three vertical retrace counter control functions are
  217.      only available on VGX, VGXT, VTX, Reality Engine, Reality Engine 2, Elan,
  218.      and Extreme graphics systems.  These functions work in immediate mode
  219.      only, with graphics rendered locally.
  220.  
  221.    TTTTaaaabbbblllleeeetttt ccccoooooooorrrrddddiiiinnnnaaaatttteeee ssssccccaaaalllliiiinnnngggg ((((GGGGLLLLCCCCTTTTAAAABBBB))))
  222.      The value of GGGGLLLLCCCCTTTTAAAABBBB is applicable only when the tablet controls the
  223.      pointer (graphics cursor).  In that case, the value determines how tablet
  224.      coordinates are mapped to screen coordinates.
  225.  
  226.      If the value is _0, there is a 1-1 mapping between tablet coordinates and
  227.      screen coordinates, so that on a typical tablet, only the lower left
  228.      quadrant will be mapped to the screen.
  229.  
  230.      If the value is _1 (the default), then "iso" scaling is performed.  That
  231.      is, as much of the tablet as possible is mapped to the screen, with the
  232.      restriction that a 1-1 aspect ratio is preserved.  (I.e. the same scaling
  233.      is applied to both x and y.)
  234.  
  235.      If the value is _2, then the entire tablet is mapped to the entire screen.
  236.      (This is called "fit" scaling.)
  237.  
  238. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  239.      getgde, lRGBra, lsetde, lshade, imakeb, glresources
  240.  
  241. NNNNOOOOTTTTEEEESSSS
  242.      This routine is available only in immediate mode.
  243.  
  244.      The state of old-style polygon mode is ignored on IRIS-4D B and G models.
  245.  
  246. BBBBUUUUGGGG
  247.      GLCZRA should be a per-window mode.
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.